home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / 1st_b110.zip / NEWFILES.DOC < prev    next >
Text File  |  1993-01-26  |  9KB  |  218 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               The NEWFILES System
  8.                          Copyright 1992 by Mark Herring
  9.                               All Rights Reserved
  10.  
  11.  
  12.  
  13.          The Newfiles system is designed to work with Sparkware's
  14.          Qmail DeLuxe² 1.26 offline mail reader or the 1stReader 1.02
  15.          offline mail system.
  16.  
  17.          Newfiles lets you tag files stored in the new files lists
  18.          that can be included inside mail packets created by
  19.          Sparkware's Qmail Door 4.00 system.  These tagged file
  20.          requests are then automatically moved back to The Qmail Door
  21.          where the files are included in the next mail packet you
  22.          download.
  23.  
  24.          Please note that Newfiles will only work with packets created
  25.          by The Qmail Door.  Your sysop needs to be using Qmail Door
  26.          4.00ß released on or after November 11th, 1992 *and* also
  27.          have installed the QM-FILE system on the BBS.  You can tell
  28.          if the Qmail Door you use supports this system by looking for
  29.          a file named "DOOR.ID" inside your QWK packets.  If this file
  30.          is found it must contain the entry:
  31.  
  32.                               REQUEST = SPARKWARE
  33.  
  34.          inside the file.  Otherwise, NEWFILES.EXE displays the new
  35.          files list as a standard text file.
  36.  
  37.  
  38.  
  39.          Using Newfiles
  40.          --------------
  41.  
  42.          Once you are inside the Newfiles program you will see a list
  43.          of new files on your screen.  Each file has a letter besides
  44.          the filename.  All files are sorted in order alphabetically
  45.          by filename.
  46.  
  47.          You can use the cursor keys on your keypad to move around the
  48.          files listing.  If you are using a mouse then cursor keys are
  49.          provided for you on the lower right section of the screen.
  50.          You can click on these buttons to go to the TOP of the file
  51.          listing, the END (or bottom) of the file list, or move one
  52.          page UP or DOWN in the listing.
  53.  
  54.          If you wish to tag the file for downloading all you need to
  55.          do is press the letter associated with the filename.  If the
  56.          letter blinks then that filename has been tagged for
  57.          downloading.  If the letter changes from blinking to a solid
  58.          color then the file is 'untagged'.  If you are using a mouse
  59.          you can tag (or untag) a file simply by clicking the left
  60.          button while the mouse cursor is on the file description.
  61.  
  62.          When you tag files for downloading your request is included
  63.          inside the .REP mail packet.  In order to receive your tagged
  64.          files you must upload your REP mail packet to The Qmail Door
  65.          *first* and then immediately download a new QWK mail packet.
  66.          Your tagged files will be included inside the QWK packet.
  67.  
  68.  
  69.  
  70.          Change views
  71.          ------------
  72.  
  73.          If you press the '2' key on your keyboard (or click on the
  74.          'Change views' button with your mouse) you can change the
  75.          file views on the screen.  These views rotate, in order, from
  76.          one view to the next.  The views will then repeat themselves.
  77.  
  78.          Four views are provided by Newfiles:
  79.  
  80.                    ■    "All files"   This view shows all files
  81.                         included in the mail packet.
  82.  
  83.                    ■    "Tagged files"  This view shows all files
  84.                         you have tagged for downloading.  You will
  85.                         only see this view if you have tagged files
  86.                         for downloading.
  87.  
  88.                    ■    "Zippy files"  This view shows files that
  89.                         meet your last 'ZIPPY' search (see 'Zippy
  90.                         search' for more information).  You will only
  91.                         see this view if you have performed a zippy
  92.                         scan.
  93.  
  94.                    ■    "File counts"  This view shows you how many
  95.                         files were found in each conference.
  96.  
  97.  
  98.  
  99.          Find filename
  100.          -------------
  101.  
  102.          The FIND command lets you quickly find a filename.  If you
  103.          want to find the first file that begins with "M" you should
  104.          enter "M" as the filename.  Unlike the ZIPPY command, FIND
  105.          will only match a filename, not a file description.
  106.  
  107.  
  108.  
  109.          Zippy search
  110.          ------------
  111.  
  112.          The ZIPPY command finds files that contain a keyword in
  113.          either the filename or file description.  When Newfiles
  114.          displays files found in the ZIPPY scan the keywords will
  115.          blink on the screen.
  116.  
  117.          You can use the Zippy command to find any text you desire.
  118.          For example, you can locate all of the files that contain
  119.          the keyword "QWK".
  120.  
  121.          Zippy can also be used to find all of the files in just one
  122.          conference.  Use the keyword "Conf #xxx" where "xxx" is the
  123.          conference number.
  124.  
  125.  
  126.  
  127.          Quit
  128.          ----
  129.  
  130.          The QUIT command exits the Newfiles program and will return
  131.          control back to your offline mail reader.  If you have tagged
  132.          any files while in Newfiles (or have previously tagged files
  133.          still available) then you will be asked if you wish to save
  134.          your changes.
  135.  
  136.          If you select the "YES" button then the changes are saved to
  137.          disk.  The next time you call a Qmail Door 4.00 system that
  138.          is setup for file requests your requests will be passed up to
  139.          the door.
  140.  
  141.          If you select the "NO" button then the changes are discarded.
  142.  
  143.  
  144.  
  145.          Special keys
  146.          ------------
  147.  
  148.          While you are viewing the new files list inside Newfiles, you
  149.          can press the F2 key to view the file list in it's 'normal'
  150.          text file view.  The F5 key will also let you shell to DOS
  151.          while inside Newfiles.
  152.  
  153.  
  154.  
  155.          NEWFILES.CFG and NEWFILES.IN
  156.          ----------------------------
  157.  
  158.          NEWFILES.CFG (for Qmail DeLuxe²) or NEWFILES.IN (for 1stReader)
  159.          is used by Newfiles to locate the subdirectories used by your
  160.          reader.  You do not need to change the information in these
  161.          files in order to use Newfiles.  However, if you wish, you can
  162.          edit this file.  Here is a brief description of each line in
  163.          the configuration file:
  164.  
  165.          Line #1       Path to the reader system subdirectory
  166.  
  167.                        This entry points to the 'home' subdirectory for
  168.                        your offline mail reader.
  169.  
  170.          Line #2       Path to the work subdirectory
  171.  
  172.                        This entry points to the location of your
  173.                        reader's 'work' subdirectory.  This is where your
  174.                        mail reader unpacks mail packets.
  175.  
  176.          Line #3       Path to the replies subdirectory
  177.  
  178.                        This entry points to the subdirectory where your
  179.                        offline mail reader stores files that are bundled
  180.                        into your .REP mail packet.
  181.  
  182.          Line #4       Path to the BBS subdirectory
  183.  
  184.                        Qmail DeLuxe² does not keep a 'BBS' subdirectory
  185.                        for its systems.  1stReader does use a BBS
  186.                        subdirectory tree and this entry points to that
  187.                        location.
  188.  
  189.          Line #5       Name of the BBS ID
  190.  
  191.                        This is the name of the MAIL packet ID used to
  192.                        create the QWK mail packet.  For example, if the
  193.                        mail packet is named "SPARKY.QWK" then this field
  194.                        contains SPARKY.
  195.  
  196.                        If this field is left blank then Newfiles reads
  197.                        this information from CONTROL.DAT.
  198.  
  199.          Line #6       Name of the BBS system
  200.  
  201.                        This is the name of the BBS system.  If this field
  202.                        is left blank then Newfiles reads this information
  203.                        from CONTROL.DAT.
  204.  
  205.          Line #7       "-1" if color otherwise "0" or blank for monochrome
  206.  
  207.                        This line determines if Newfiles is displayed in
  208.                        color or 'black and white' mode.  If you place a
  209.                        question mark in this field then Newfiles checks
  210.                        to see what type of monitor you are using.
  211.  
  212.          Line #8       "-1" if you want to use a mouse, "0" or blank to
  213.                        turn off the mouse.
  214.  
  215.                        If you place a question mark in this field then
  216.                        Newfiles checks to see if you have a mouse
  217.                        installed on your system.
  218.